<!DOCTYPE html>
<html lang="en-US">
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
<meta http-equiv="X-UA-Compatible" content="IE=edge">
<title>expand_region [HALCON算子参考手册]</title>
<style type="text/css">
      body {
    color: #000000;
    background-color: #ffffff;
    margin: 0;
    font-family: Arial, Helvetica, sans-serif;
}

.body_main {
    margin-left: 35px;
    margin-right: 35px;
}

@media screen and (min-width:992px) {

    .body_main {
        margin-left: 10%;
        margin-right: 10%;
    }

    table.toctable {
        width: 80%
    }
}

@media screen and (min-width:1400px) {

    .body_main {
        margin-left: 15%;
        margin-right: 15%;
    }

    table.toctable {
        width: 70%
    }
}

body>div ul ul {
    margin-left: inherit;
}

a:link {
    color: #0044cc;
}

a:link,
a:visited {
    text-decoration: none;
}

a:link:hover,
a:visited:hover {
    text-decoration: underline;
}

th {
    text-align: left;
}

h1,
h2,
h3,
h4,
h5,
h6 {
    text-rendering: optimizeLegibility;
    color: #666666;
}

code {
    font-family: monospace,monospace;
}

h1 a.halconoperator {
    font-family: Arial, Helvetica, sans-serif;
    color: #666666;
}

h2 a.halconoperator {
    font-family: Arial, Helvetica, sans-serif;
    color: #666666;
}

hr {
    border: 0;
    border-top: solid 1px #f28d26;
}

.pre {
    display: block;
    padding-bottom: 1ex;
    font-family: monospace;
    white-space: pre;
}

pre {
    font-family: monospace, monospace;
    padding: 1ex;
    white-space: pre-wrap;
}

.toc {
    font-size: 80%;
    border-top: 1px dashed #f28d26;
    border-bottom: 1px dashed #f28d26;
    padding-top: 5px;
    padding-bottom: 5px;
}

.inv {
    margin: 0;
    border: 0;
    padding: 0;
}

.banner {
    color: #666666;
    padding-left: 1em;
}

.logo {
    background-color: white;
}

.keyboard {
    font-size: 80%;
    padding-left: 3px;
    padding-right: 3px;
    border-radius: 5px;
    border-width: 1px;
    border-style: solid;
    border-color: #f28d26;
    background-color: #f3f3f3;
}

.warning {
    margin-top: 2ex;
    margin-bottom: 1ex;
    padding: 10px;
    text-align: center;
    border: 1px solid;
    color: #bb0000;
    background-color: #fff7f7
}

.imprint {
    margin-top: 1ex;
    font-size: 80%;
    color: #666666;
}

.imprinthead {
    font-weight: bolder;
    color: #666666;
}

.indexlink {
    text-align: right;
    padding-bottom: 5px;
}

.postscript {
    margin-top: 2ex;
    font-size: 80%;
    color: #666666
}

.evenrow {
    background-color: #e7e7ef;
    vertical-align: top;
}

.oddrow {
    background-color: #f7f7ff;
    vertical-align: top;
}

.headrow {
    background-color: #97979f;
    color: #ffffff;
    vertical-align: top;
}

.logorow {
    vertical-align: top;
}

.error {
    color: red;
}

.var {
    font-style: italic
}

.halconoperator {
    font-family: monospace, monospace;
}

span.operator {
    font-family: monospace, monospace;
}

span.procedure {
    font-family: monospace, monospace;
}

span.operation {
    font-family: monospace, monospace;
}

span.feature {
    font-family: Arial, Helvetica, Homerton, sans-serif;
}

ul {
    padding-left: 1.2em;
}

li.dot {
    list-style-type: square;
    color: #f28d26;
}

.breadcrumb {
    font-size: 80%;
    color: white;
    background-color: #062d64;
    margin-bottom: 20px;
    padding-left: 35px;
    padding-right: 35px;
    padding-bottom: 15px;
}

.webbar {
    font-size: 80%;
    background-color: #dddddd;
    margin-top: 0px;
    margin-left: -35px;
    margin-right: -35px;
    margin-bottom: 0px;
    padding-top: 5px;
    padding-left: 35px;
    padding-right: 35px;
    padding-bottom: 5px;
}

.footer {
    display: flex;
    flex-wrap: wrap;
    justify-content: space-between;
    border-top: 1px dashed #f28d26;
    font-size: 80%;
    color: #666666;
    padding-bottom: 8px;
}

.footer .socialmedia a {
    padding-left: 7px;
}

.socialmedia {
    padding-top: 10px;
}

.copyright {
    margin-top: 19px;
}

.breadcrumb a {
    color: #ffffff;
    border-bottom: 1px solid white;
}

.breadcrumb a:link:hover,
.breadcrumb a:visited:hover {
    text-decoration: none;
    border-bottom: none;
}

.heading {
    margin-top: 1ex;
    font-size: 110%;
    font-weight: bold;
    color: #666666;
}

.text {
    color: black;
}

.example {
    font-size: 80%;
    background-color: #f3f3f3;
    border: 1px dashed #666666;
    padding: 10px;
}

.displaymath {
    display: block;
    text-align: center;
    margin-top: 1ex;
    margin-bottom: 1ex;
}

.title {
    float: left;
    padding-top: 3px;
    padding-bottom: 3px;
}

.signnote {
    font-family: Arial, Helvetica, Homerton, sans-serif;
    font-size: 80%;
    color: #666666;
    font-weight: lighter;
    font-style: italic
}

.par {
    margin-bottom: 1.5em;
}

.parhead {
    text-align: right;
}

.parname {
    float: left;
}

.pardesc {
    font-size: 85%;
    margin-top: 0.5em;
    margin-bottom: 0.5em;
    margin-left: 2em;
}

.parcat {
    color: #666;
    font-weight: bold;
}

*[data-if=cpp],
*[data-if=c],
*[data-if=dotnet],
*[data-if=com],
*[data-if=python] {
    display: none;
}

.tabbar {
    text-align: right;
    border-bottom: 1px solid #f28d26;
    margin-bottom: 0.5em;
}

ul.tabs {
    padding-top: 3px;
    padding-bottom: 3px;
    margin-top: 10px;
    margin-bottom: 0;
    font-size: 80%
}

ul.tabs li {
    padding-top: 3px;
    padding-bottom: 3px;
    display: inline;
    overflow: hidden;
    list-style-type: none;
    margin: 0;
    margin-left: 8px;
    border-top: 1px solid #666;
    border-left: 1px solid #666;
    border-right: 1px solid #666;
}

ul.tabs li.active {
    border-left: 1px solid #f28d26;
    border-right: 1px solid #f28d26;
    border-top: 1px solid #f28d26;
    border-bottom: 1px solid #fff;
}

ul.tabs li.inactive {
    background-color: #eee;
}

ul.tabs li a {
    padding-left: 5px;
    padding-right: 5px;
    color: #666;
}

ul.tabs li a:link:hover {
    text-decoration: none;
}

ul.tabs li.inactive a {
    color: #666;
}

ul.tabs li.active a {
    color: black;
}

dl.generic dd {
    margin-bottom: 1em;
}

.pari {
    color: olive;
}

.paro {
    color: maroon;
}

.comment {
    font-size: 80%;
    color: green;
    white-space: nowrap;
}

table.grid {
    border-collapse: collapse;
}

table.grid td {
    padding: 5px;
    border: 1px solid;
}

table.layout {
    border: 0px;
}

table.layout td {
    padding: 5px;
}

table.table {
    border-collapse: collapse;
}

table.table td {
    padding: 5px;
    border-left: 0px;
    border-right: 0px;
}

table.table tr:last-child {
    border-bottom: 1px solid;
}

table.table th {
    padding: 5px;
    border-top: 1px solid;
    border-bottom: 1px solid;
    border-left: 0px;
    border-right: 0px;
}

.details_summary {
    cursor: pointer;
}

table.toctable {
    width: 100%;
}

table.toctable col:first-child {
    width: 20%;
}

table.toctable col:nth-last-child(2) {
    width: 8%;
}

table.altcolored tr:nth-child(even) {
    background-color: #f3f3f3;
}

    </style>
<!--OP_REF_STYLE_END-->
<script>
    <!--
var active_lang='hdevelop';function switchVisibility(obj,active_lang,new_lang)
{var display_style='inline';
for(var i=0;i<obj.length;i++)
{if(obj.item(i).getAttribute('data-if')==new_lang)
{obj.item(i).style.display=display_style;}
if(obj.item(i).getAttribute('data-if')==active_lang)
{obj.item(i).style.display='none';}}
return;}
function toggleLanguage(new_lang,initial)
{if(active_lang!=new_lang)
{var lis=document.getElementsByTagName('li');for(var i=0;i<lis.length;i++)
{if(lis.item(i).id=='syn-'+new_lang)
{lis.item(i).className='active';}
else
{lis.item(i).className='inactive';}}
var divs=document.getElementsByTagName('div');var spans=document.getElementsByTagName('span');switchVisibility(divs,active_lang,new_lang);switchVisibility(spans,active_lang,new_lang);if(!initial)
{setCookie("halcon_reference_language",new_lang,null,null);}
active_lang=new_lang;}
return;}
function setCookie(name,value,domain,exp_offset,path,secure)
{localStorage.setItem(name,value);}
function getCookie(name)
{return localStorage.getItem(name);}
function initialize()
{var qs=location.href.split('?')[1];var qs_lang_raw=location.href.split('interface=')[1];var qs_lang;if(qs_lang_raw)
{qs_lang=qs_lang_raw.split('#')[0];}
var cookie_lang=getCookie("halcon_reference_language");var new_lang;if((qs_lang=="hdevelop")||(qs_lang=="dotnet")||(qs_lang=="python")||(qs_lang=="cpp")||(qs_lang=="c"))
{new_lang=qs_lang;setCookie("halcon_reference_language",new_lang,null,null);}
else if((cookie_lang=="hdevelop")||(cookie_lang=="dotnet")||(cookie_lang=="python")||(cookie_lang=="cpp")||(cookie_lang=="c"))
{new_lang=cookie_lang;}
else
{new_lang="hdevelop";}
toggleLanguage(new_lang,1);return;}
-->

  </script>
</head>
<body onload="initialize();">
<div class="breadcrumb">
<br class="inv"><a href="index.html">目录</a> / <a href="toc_regions.html">区域</a> / <a href="toc_regions_transformations.html">变换</a><br class="inv">
</div>
<div class="body_main">
<div class="tabbar"><ul class="tabs">
<li id="syn-hdevelop" class="active"><a href="javascript:void(0);" onclick="toggleLanguage('hdevelop')" onfocus="blur()">HDevelop</a></li>
<li id="syn-dotnet" class="inactive"><a href="javascript:void(0);" onclick="toggleLanguage('dotnet')" onfocus="blur()">.NET</a></li>
<li id="syn-python" class="inactive"><a href="javascript:void(0);" onclick="toggleLanguage('python')" onfocus="blur()">Python</a></li>
<li id="syn-cpp" class="inactive"><a href="javascript:void(0);" onclick="toggleLanguage('cpp')" onfocus="blur()">C++</a></li>
<li id="syn-c" class="inactive"><a href="javascript:void(0);" onclick="toggleLanguage('c')" onfocus="blur()">C</a></li>
</ul></div>
<div class="indexlink">
<a href="index_classes.html"><span data-if="dotnet" style="display:none;">类别</span><span data-if="cpp" style="display:none;">类别</span></a><span data-if="dotnet" style="display:none;"> | </span><span data-if="cpp" style="display:none;"> | </span><a href="index_by_name.html">算子列表</a>
</div>
<!--OP_REF_HEADER_END-->
<h1 id="sec_name">
<span data-if="hdevelop" style="display:inline;">expand_region</span><span data-if="c" style="display:none;">expand_region</span><span data-if="cpp" style="display:none;">ExpandRegion</span><span data-if="dotnet" style="display:none;">ExpandRegion</span><span data-if="python" style="display:none;">expand_region</span> (算子名称)</h1>
<h2>名称</h2>
<p><code><span data-if="hdevelop" style="display:inline;">expand_region</span><span data-if="c" style="display:none;">expand_region</span><span data-if="cpp" style="display:none;">ExpandRegion</span><span data-if="dotnet" style="display:none;">ExpandRegion</span><span data-if="python" style="display:none;">expand_region</span></code> — Fill gaps between regions or split overlapping regions.</p>
<h2 id="sec_synopsis">参数签名</h2>
<div data-if="hdevelop" style="display:inline;">
<p>
<code><b>expand_region</b>(<a href="#Regions"><i>区域</i></a>, <a href="#ForbiddenArea"><i>ForbiddenArea</i></a> : <a href="#RegionExpanded"><i>RegionExpanded</i></a> : <a href="#Iterations"><i>Iterations</i></a>, <a href="#Mode"><i>Mode</i></a> : )</code></p>
</div>
<div data-if="c" style="display:none;">
<p>
<code>Herror <b>expand_region</b>(const Hobject <a href="#Regions"><i>区域</i></a>, const Hobject <a href="#ForbiddenArea"><i>ForbiddenArea</i></a>, Hobject* <a href="#RegionExpanded"><i>RegionExpanded</i></a>, const Hlong <a href="#Iterations"><i>Iterations</i></a>, const char* <a href="#Mode"><i>Mode</i></a>)</code></p>
<p>
<code>Herror <b>T_expand_region</b>(const Hobject <a href="#Regions"><i>区域</i></a>, const Hobject <a href="#ForbiddenArea"><i>ForbiddenArea</i></a>, Hobject* <a href="#RegionExpanded"><i>RegionExpanded</i></a>, const Htuple <a href="#Iterations"><i>Iterations</i></a>, const Htuple <a href="#Mode"><i>Mode</i></a>)</code></p>
</div>
<div data-if="cpp" style="display:none;">
<p>
<code>void <b>ExpandRegion</b>(const HObject&amp; <a href="#Regions"><i>区域</i></a>, const HObject&amp; <a href="#ForbiddenArea"><i>ForbiddenArea</i></a>, HObject* <a href="#RegionExpanded"><i>RegionExpanded</i></a>, const HTuple&amp; <a href="#Iterations"><i>Iterations</i></a>, const HTuple&amp; <a href="#Mode"><i>Mode</i></a>)</code></p>
<p>
<code><a href="HRegion.html">HRegion</a> <a href="HRegion.html">HRegion</a>::<b>ExpandRegion</b>(const HRegion&amp; <a href="#ForbiddenArea"><i>ForbiddenArea</i></a>, const HTuple&amp; <a href="#Iterations"><i>Iterations</i></a>, const HString&amp; <a href="#Mode"><i>Mode</i></a>) const</code></p>
<p>
<code><a href="HRegion.html">HRegion</a> <a href="HRegion.html">HRegion</a>::<b>ExpandRegion</b>(const HRegion&amp; <a href="#ForbiddenArea"><i>ForbiddenArea</i></a>, Hlong <a href="#Iterations"><i>Iterations</i></a>, const HString&amp; <a href="#Mode"><i>Mode</i></a>) const</code></p>
<p>
<code><a href="HRegion.html">HRegion</a> <a href="HRegion.html">HRegion</a>::<b>ExpandRegion</b>(const HRegion&amp; <a href="#ForbiddenArea"><i>ForbiddenArea</i></a>, Hlong <a href="#Iterations"><i>Iterations</i></a>, const char* <a href="#Mode"><i>Mode</i></a>) const</code></p>
<p>
<code><a href="HRegion.html">HRegion</a> <a href="HRegion.html">HRegion</a>::<b>ExpandRegion</b>(const HRegion&amp; <a href="#ForbiddenArea"><i>ForbiddenArea</i></a>, Hlong <a href="#Iterations"><i>Iterations</i></a>, const wchar_t* <a href="#Mode"><i>Mode</i></a>) const  <span class="signnote">
            (
            Windows only)
          </span></code></p>
</div>
<div data-if="com" style="display:none;"></div>
<div data-if="dotnet" style="display:none;">
<p>
<code>static void <a href="HOperatorSet.html">HOperatorSet</a>.<b>ExpandRegion</b>(<a href="HObject.html">HObject</a> <a href="#Regions"><i>区域</i></a>, <a href="HObject.html">HObject</a> <a href="#ForbiddenArea"><i>forbiddenArea</i></a>, out <a href="HObject.html">HObject</a> <a href="#RegionExpanded"><i>regionExpanded</i></a>, <a href="HTuple.html">HTuple</a> <a href="#Iterations"><i>iterations</i></a>, <a href="HTuple.html">HTuple</a> <a href="#Mode"><i>mode</i></a>)</code></p>
<p>
<code><a href="HRegion.html">HRegion</a> <a href="HRegion.html">HRegion</a>.<b>ExpandRegion</b>(<a href="HRegion.html">HRegion</a> <a href="#ForbiddenArea"><i>forbiddenArea</i></a>, <a href="HTuple.html">HTuple</a> <a href="#Iterations"><i>iterations</i></a>, string <a href="#Mode"><i>mode</i></a>)</code></p>
<p>
<code><a href="HRegion.html">HRegion</a> <a href="HRegion.html">HRegion</a>.<b>ExpandRegion</b>(<a href="HRegion.html">HRegion</a> <a href="#ForbiddenArea"><i>forbiddenArea</i></a>, int <a href="#Iterations"><i>iterations</i></a>, string <a href="#Mode"><i>mode</i></a>)</code></p>
</div>
<div data-if="python" style="display:none;">
<p>
<code>def <b>expand_region</b>(<a href="#Regions"><i>区域</i></a>: HObject, <a href="#ForbiddenArea"><i>forbidden_area</i></a>: HObject, <a href="#Iterations"><i>iterations</i></a>: Union[int, str], <a href="#Mode"><i>mode</i></a>: str) -&gt; HObject</code></p>
</div>
<h2 id="sec_description">描述</h2>
<p><code><span data-if="hdevelop" style="display:inline">expand_region</span><span data-if="c" style="display:none">expand_region</span><span data-if="cpp" style="display:none">ExpandRegion</span><span data-if="com" style="display:none">ExpandRegion</span><span data-if="dotnet" style="display:none">ExpandRegion</span><span data-if="python" style="display:none">expand_region</span></code> closes gaps between the input regions, which
resulted from the suppression of small regions in a segmentation
operator, for example, (mode <i><span data-if="hdevelop" style="display:inline">'image'</span><span data-if="c" style="display:none">"image"</span><span data-if="cpp" style="display:none">"image"</span><span data-if="com" style="display:none">"image"</span><span data-if="dotnet" style="display:none">"image"</span><span data-if="python" style="display:none">"image"</span></i>), or to separate
overlapping regions (mode <i><span data-if="hdevelop" style="display:inline">'region'</span><span data-if="c" style="display:none">"region"</span><span data-if="cpp" style="display:none">"region"</span><span data-if="com" style="display:none">"region"</span><span data-if="dotnet" style="display:none">"region"</span><span data-if="python" style="display:none">"region"</span></i>).  Both uses result from the
expansion of regions.  该算子 works by adding or removing a
one pixel wide “strip” to a region.
</p>
<p>The expansion takes place only in regions that are designated as
not “forbidden” (parameter <a href="#ForbiddenArea"><i><code><span data-if="hdevelop" style="display:inline">ForbiddenArea</span><span data-if="c" style="display:none">ForbiddenArea</span><span data-if="cpp" style="display:none">ForbiddenArea</span><span data-if="com" style="display:none">ForbiddenArea</span><span data-if="dotnet" style="display:none">forbiddenArea</span><span data-if="python" style="display:none">forbidden_area</span></code></i></a>).  The number
of iterations is determined by the parameter <a href="#Iterations"><i><code><span data-if="hdevelop" style="display:inline">Iterations</span><span data-if="c" style="display:none">Iterations</span><span data-if="cpp" style="display:none">Iterations</span><span data-if="com" style="display:none">Iterations</span><span data-if="dotnet" style="display:none">iterations</span><span data-if="python" style="display:none">iterations</span></code></i></a>.
By passing <i><span data-if="hdevelop" style="display:inline">'maximal'</span><span data-if="c" style="display:none">"maximal"</span><span data-if="cpp" style="display:none">"maximal"</span><span data-if="com" style="display:none">"maximal"</span><span data-if="dotnet" style="display:none">"maximal"</span><span data-if="python" style="display:none">"maximal"</span></i>, <code><span data-if="hdevelop" style="display:inline">expand_region</span><span data-if="c" style="display:none">expand_region</span><span data-if="cpp" style="display:none">ExpandRegion</span><span data-if="com" style="display:none">ExpandRegion</span><span data-if="dotnet" style="display:none">ExpandRegion</span><span data-if="python" style="display:none">expand_region</span></code> iterates until
convergence, i.e., until no more changes occur.  By passing 0 for
this parameter, all non-overlapping regions are returned.  The two
modes of operation (<i><span data-if="hdevelop" style="display:inline">'image'</span><span data-if="c" style="display:none">"image"</span><span data-if="cpp" style="display:none">"image"</span><span data-if="com" style="display:none">"image"</span><span data-if="dotnet" style="display:none">"image"</span><span data-if="python" style="display:none">"image"</span></i> and <i><span data-if="hdevelop" style="display:inline">'region'</span><span data-if="c" style="display:none">"region"</span><span data-if="cpp" style="display:none">"region"</span><span data-if="com" style="display:none">"region"</span><span data-if="dotnet" style="display:none">"region"</span><span data-if="python" style="display:none">"region"</span></i>) are
different in the following ways:
</p>
<dl class="generic">

<dt><b>'image'</b></dt>
<dd><p>

The input regions are expanded iteratively until they
touch another region or the image border.
In this case, the image border is defined to be the
rectangle ranging from (0,0) to (row_max,col_max).
Here, (row_max,col_max) corresponds to the lower right
corner of the smallest surrounding rectangle of all input regions
(i.e., of all regions that are passed in <a href="#Regions"><i><code><span data-if="hdevelop" style="display:inline">区域</span><span data-if="c" style="display:none">区域</span><span data-if="cpp" style="display:none">区域</span><span data-if="com" style="display:none">区域</span><span data-if="dotnet" style="display:none">区域</span><span data-if="python" style="display:none">区域</span></code></i></a> and
<a href="#ForbiddenArea"><i><code><span data-if="hdevelop" style="display:inline">ForbiddenArea</span><span data-if="c" style="display:none">ForbiddenArea</span><span data-if="cpp" style="display:none">ForbiddenArea</span><span data-if="com" style="display:none">ForbiddenArea</span><span data-if="dotnet" style="display:none">forbiddenArea</span><span data-if="python" style="display:none">forbidden_area</span></code></i></a>).
Because <code><span data-if="hdevelop" style="display:inline">expand_region</span><span data-if="c" style="display:none">expand_region</span><span data-if="cpp" style="display:none">ExpandRegion</span><span data-if="com" style="display:none">ExpandRegion</span><span data-if="dotnet" style="display:none">ExpandRegion</span><span data-if="python" style="display:none">expand_region</span></code> processes all regions simultaneously,
gaps between regions are distributed evenly to all
regions.  Overlapping regions are split by distributing
the area of overlap evenly to both regions.
</p></dd>

<dt><b>'region'</b></dt>
<dd><p>

No expansion of the input regions is performed.  Instead,
only overlapping regions are split by distributing the
area of overlap evenly to the respective regions.  Because
the intersection with the original region is computed
after the shrinking operation gaps in the output regions
may result, i.e., the segmentation is not complete.  This
can be prevented by calling <code><span data-if="hdevelop" style="display:inline">expand_region</span><span data-if="c" style="display:none">expand_region</span><span data-if="cpp" style="display:none">ExpandRegion</span><span data-if="com" style="display:none">ExpandRegion</span><span data-if="dotnet" style="display:none">ExpandRegion</span><span data-if="python" style="display:none">expand_region</span></code> a second
time with the complement of the original regions as
“forbidden area.”
</p></dd>
</dl>
<h2 id="sec_execution">运行信息</h2>
<ul>
  <li>多线程类型:可重入(与非独占操作符并行运行)。</li>
<li>多线程作用域:全局(可以从任何线程调用)。</li>
  <li>未经并行化处理。</li>
</ul>
<h2 id="sec_parameters">参数表</h2>
  <div class="par">
<div class="parhead">
<span id="Regions" class="parname"><b><code><span data-if="hdevelop" style="display:inline">区域</span><span data-if="c" style="display:none">区域</span><span data-if="cpp" style="display:none">区域</span><span data-if="com" style="display:none">区域</span><span data-if="dotnet" style="display:none">区域</span><span data-if="python" style="display:none">区域</span></code></b> (input_object)  </span><span>region(-array) <code>→</code> <span data-if="hdevelop" style="display:inline">object</span><span data-if="dotnet" style="display:none"><a href="HRegion.html">HRegion</a></span><span data-if="python" style="display:none">HObject</span><span data-if="cpp" style="display:none"><a href="HRegion.html">HRegion</a></span><span data-if="c" style="display:none">Hobject</span></span>
</div>
<p class="pardesc">Regions for which the gaps are to be closed, or which
are to be separated.</p>
</div>
  <div class="par">
<div class="parhead">
<span id="ForbiddenArea" class="parname"><b><code><span data-if="hdevelop" style="display:inline">ForbiddenArea</span><span data-if="c" style="display:none">ForbiddenArea</span><span data-if="cpp" style="display:none">ForbiddenArea</span><span data-if="com" style="display:none">ForbiddenArea</span><span data-if="dotnet" style="display:none">forbiddenArea</span><span data-if="python" style="display:none">forbidden_area</span></code></b> (input_object)  </span><span>region <code>→</code> <span data-if="hdevelop" style="display:inline">object</span><span data-if="dotnet" style="display:none"><a href="HRegion.html">HRegion</a></span><span data-if="python" style="display:none">HObject</span><span data-if="cpp" style="display:none"><a href="HRegion.html">HRegion</a></span><span data-if="c" style="display:none">Hobject</span></span>
</div>
<p class="pardesc">Regions in which no expansion takes place.</p>
</div>
  <div class="par">
<div class="parhead">
<span id="RegionExpanded" class="parname"><b><code><span data-if="hdevelop" style="display:inline">RegionExpanded</span><span data-if="c" style="display:none">RegionExpanded</span><span data-if="cpp" style="display:none">RegionExpanded</span><span data-if="com" style="display:none">RegionExpanded</span><span data-if="dotnet" style="display:none">regionExpanded</span><span data-if="python" style="display:none">region_expanded</span></code></b> (output_object)  </span><span>region(-array) <code>→</code> <span data-if="hdevelop" style="display:inline">object</span><span data-if="dotnet" style="display:none"><a href="HRegion.html">HRegion</a></span><span data-if="python" style="display:none">HObject</span><span data-if="cpp" style="display:none"><a href="HRegion.html">HRegion</a></span><span data-if="c" style="display:none">Hobject *</span></span>
</div>
<p class="pardesc">Expanded or separated regions.</p>
</div>
  <div class="par">
<div class="parhead">
<span id="Iterations" class="parname"><b><code><span data-if="hdevelop" style="display:inline">Iterations</span><span data-if="c" style="display:none">Iterations</span><span data-if="cpp" style="display:none">Iterations</span><span data-if="com" style="display:none">Iterations</span><span data-if="dotnet" style="display:none">iterations</span><span data-if="python" style="display:none">iterations</span></code></b> (input_control)  </span><span>integer <code>→</code> <span data-if="dotnet" style="display:none"><a href="HTuple.html">HTuple</a></span><span data-if="python" style="display:none">Union[int, str]</span><span data-if="cpp" style="display:none"><a href="HTuple.html">HTuple</a></span><span data-if="c" style="display:none">Htuple</span><span data-if="hdevelop" style="display:inline"> (integer / </span><span data-if="hdevelop" style="display:inline">string)</span><span data-if="dotnet" style="display:none"> (<i>int</i> / </span><span data-if="dotnet" style="display:none">long / </span><span data-if="dotnet" style="display:none">string)</span><span data-if="cpp" style="display:none"> (<i>Hlong</i> / </span><span data-if="cpp" style="display:none">HString)</span><span data-if="c" style="display:none"> (<i>Hlong</i> / </span><span data-if="c" style="display:none">char*)</span></span>
</div>
<p class="pardesc">Number of iterations.</p>
<p class="pardesc"><span class="parcat">Default:
      </span>
    <span data-if="hdevelop" style="display:inline">'maximal'</span>
    <span data-if="c" style="display:none">"maximal"</span>
    <span data-if="cpp" style="display:none">"maximal"</span>
    <span data-if="com" style="display:none">"maximal"</span>
    <span data-if="dotnet" style="display:none">"maximal"</span>
    <span data-if="python" style="display:none">"maximal"</span>
</p>
<p class="pardesc"><span class="parcat">Suggested values:
      </span><span data-if="hdevelop" style="display:inline">'maximal'</span><span data-if="c" style="display:none">"maximal"</span><span data-if="cpp" style="display:none">"maximal"</span><span data-if="com" style="display:none">"maximal"</span><span data-if="dotnet" style="display:none">"maximal"</span><span data-if="python" style="display:none">"maximal"</span>, 0, 1, 2, 3, 5, 7, 10, 15, 20, 30, 50, 70, 100, 200</p>
<p class="pardesc"><span class="parcat">Value range:
      </span><code>0
          ≤
        
    <span data-if="hdevelop" style="display:inline">Iterations</span>
    <span data-if="c" style="display:none">Iterations</span>
    <span data-if="cpp" style="display:none">Iterations</span>
    <span data-if="com" style="display:none">Iterations</span>
    <span data-if="dotnet" style="display:none">iterations</span>
    <span data-if="python" style="display:none">iterations</span>
    
          ≤
          1000</code> (lin)</p>
<p class="pardesc"><span class="parcat">Minimum increment:
      </span>1</p>
<p class="pardesc"><span class="parcat">Recommended increment:
      </span>1</p>
</div>
  <div class="par">
<div class="parhead">
<span id="Mode" class="parname"><b><code><span data-if="hdevelop" style="display:inline">Mode</span><span data-if="c" style="display:none">Mode</span><span data-if="cpp" style="display:none">Mode</span><span data-if="com" style="display:none">Mode</span><span data-if="dotnet" style="display:none">mode</span><span data-if="python" style="display:none">mode</span></code></b> (input_control)  </span><span>string <code>→</code> <span data-if="dotnet" style="display:none"><a href="HTuple.html">HTuple</a></span><span data-if="python" style="display:none">str</span><span data-if="cpp" style="display:none"><a href="HTuple.html">HTuple</a></span><span data-if="c" style="display:none">Htuple</span><span data-if="hdevelop" style="display:inline"> (string)</span><span data-if="dotnet" style="display:none"> (<i>string</i>)</span><span data-if="cpp" style="display:none"> (<i>HString</i>)</span><span data-if="c" style="display:none"> (<i>char*</i>)</span></span>
</div>
<p class="pardesc">Expansion mode.</p>
<p class="pardesc"><span class="parcat">Default:
      </span>
    <span data-if="hdevelop" style="display:inline">'image'</span>
    <span data-if="c" style="display:none">"image"</span>
    <span data-if="cpp" style="display:none">"image"</span>
    <span data-if="com" style="display:none">"image"</span>
    <span data-if="dotnet" style="display:none">"image"</span>
    <span data-if="python" style="display:none">"image"</span>
</p>
<p class="pardesc"><span class="parcat">List of values:
      </span><span data-if="hdevelop" style="display:inline">'image'</span><span data-if="c" style="display:none">"image"</span><span data-if="cpp" style="display:none">"image"</span><span data-if="com" style="display:none">"image"</span><span data-if="dotnet" style="display:none">"image"</span><span data-if="python" style="display:none">"image"</span>, <span data-if="hdevelop" style="display:inline">'region'</span><span data-if="c" style="display:none">"region"</span><span data-if="cpp" style="display:none">"region"</span><span data-if="com" style="display:none">"region"</span><span data-if="dotnet" style="display:none">"region"</span><span data-if="python" style="display:none">"region"</span></p>
</div>
<div data-if="hdevelop" style="display:inline">
<h2 id="sec_example_hdevelop">例程 (HDevelop)</h2>
<pre class="example">
read_image(Image,'clip')
threshold(Image,Dark,0,150)
connection(Dark,ConnectedRegions)
gen_circle (Circle, 400, 400, 200.5)
expand_region (ConnectedRegions, Circle, RegionExpanded, 'maximal', 'image')
dev_display (RegionExpanded)
</pre>
</div>
<div data-if="c" style="display:none">
<h2 id="sec_example_c">例程 (C)</h2>
<pre class="example">
read_image(&amp;Image,"fabrik");
threshold(Image,&amp;Light,100.0,255.0);
disp_region(Light,WindowHandle);
connection(Light,&amp;Seg);
expand_region(Seg,EMPTY_REGION,&amp;Exp1,"maximal","image");
set_colored(WindowHandle,12);
set_draw(WindowHandle,"margin");
disp_region(Exp1,WindowHandle);
</pre>
</div>
<div data-if="cpp" style="display:none">
<h2 id="sec_example_cpp">例程 (HDevelop)</h2>
<pre class="example">
read_image(Image,'clip')
threshold(Image,Dark,0,150)
connection(Dark,ConnectedRegions)
gen_circle (Circle, 400, 400, 200.5)
expand_region (ConnectedRegions, Circle, RegionExpanded, 'maximal', 'image')
dev_display (RegionExpanded)
</pre>
</div>
<div data-if="com" style="display:none">
<h2 id="sec_example_com">例程 (HDevelop)</h2>
<pre class="example">
read_image(Image,'clip')
threshold(Image,Dark,0,150)
connection(Dark,ConnectedRegions)
gen_circle (Circle, 400, 400, 200.5)
expand_region (ConnectedRegions, Circle, RegionExpanded, 'maximal', 'image')
dev_display (RegionExpanded)
</pre>
</div>
<div data-if="dotnet" style="display:none">
<h2 id="sec_example_dotnet">例程 (HDevelop)</h2>
<pre class="example">
read_image(Image,'clip')
threshold(Image,Dark,0,150)
connection(Dark,ConnectedRegions)
gen_circle (Circle, 400, 400, 200.5)
expand_region (ConnectedRegions, Circle, RegionExpanded, 'maximal', 'image')
dev_display (RegionExpanded)
</pre>
</div>
<h2 id="sec_result">结果</h2>
<p><code><span data-if="hdevelop" style="display:inline">expand_region</span><span data-if="c" style="display:none">expand_region</span><span data-if="cpp" style="display:none">ExpandRegion</span><span data-if="com" style="display:none">ExpandRegion</span><span data-if="dotnet" style="display:none">ExpandRegion</span><span data-if="python" style="display:none">expand_region</span></code> always 返回值 <TT>2</TT> (
      <TT>H_MSG_TRUE</TT>)
    .  The behavior in
case of empty input (no regions given) can be set via
<a href="set_system.html"><code><span data-if="hdevelop" style="display:inline">set_system('no_object_result',&lt;Result&gt;)</span><span data-if="c" style="display:none">set_system("no_object_result",&lt;Result&gt;)</span><span data-if="cpp" style="display:none">SetSystem("no_object_result",&lt;Result&gt;)</span><span data-if="com" style="display:none">SetSystem("no_object_result",&lt;Result&gt;)</span><span data-if="dotnet" style="display:none">SetSystem("no_object_result",&lt;Result&gt;)</span><span data-if="python" style="display:none">set_system("no_object_result",&lt;Result&gt;)</span></code></a>,
the behavior in case of an empty input region via
<a href="set_system.html"><code><span data-if="hdevelop" style="display:inline">set_system('empty_region_result',&lt;Result&gt;)</span><span data-if="c" style="display:none">set_system("empty_region_result",&lt;Result&gt;)</span><span data-if="cpp" style="display:none">SetSystem("empty_region_result",&lt;Result&gt;)</span><span data-if="com" style="display:none">SetSystem("empty_region_result",&lt;Result&gt;)</span><span data-if="dotnet" style="display:none">SetSystem("empty_region_result",&lt;Result&gt;)</span><span data-if="python" style="display:none">set_system("empty_region_result",&lt;Result&gt;)</span></code></a>,
and the behavior in case of an empty result region via
<a href="set_system.html"><code><span data-if="hdevelop" style="display:inline">set_system('store_empty_region',&lt;'true'/'false'&gt;)</span><span data-if="c" style="display:none">set_system("store_empty_region",&lt;"true"/"false"&gt;)</span><span data-if="cpp" style="display:none">SetSystem("store_empty_region",&lt;"true"/"false"&gt;)</span><span data-if="com" style="display:none">SetSystem("store_empty_region",&lt;"true"/"false"&gt;)</span><span data-if="dotnet" style="display:none">SetSystem("store_empty_region",&lt;"true"/"false"&gt;)</span><span data-if="python" style="display:none">set_system("store_empty_region",&lt;"true"/"false"&gt;)</span></code></a>.
如有必要，将引发异常。</p>
<h2 id="sec_predecessors">可能的前置算子</h2>
<p>
<code><a href="pouring.html"><span data-if="hdevelop" style="display:inline">pouring</span><span data-if="c" style="display:none">pouring</span><span data-if="cpp" style="display:none">Pouring</span><span data-if="com" style="display:none">Pouring</span><span data-if="dotnet" style="display:none">Pouring</span><span data-if="python" style="display:none">pouring</span></a></code>, 
<code><a href="threshold.html"><span data-if="hdevelop" style="display:inline">threshold</span><span data-if="c" style="display:none">threshold</span><span data-if="cpp" style="display:none">Threshold</span><span data-if="com" style="display:none">Threshold</span><span data-if="dotnet" style="display:none">Threshold</span><span data-if="python" style="display:none">threshold</span></a></code>, 
<code><a href="dyn_threshold.html"><span data-if="hdevelop" style="display:inline">dyn_threshold</span><span data-if="c" style="display:none">dyn_threshold</span><span data-if="cpp" style="display:none">DynThreshold</span><span data-if="com" style="display:none">DynThreshold</span><span data-if="dotnet" style="display:none">DynThreshold</span><span data-if="python" style="display:none">dyn_threshold</span></a></code>, 
<code><a href="regiongrowing.html"><span data-if="hdevelop" style="display:inline">regiongrowing</span><span data-if="c" style="display:none">regiongrowing</span><span data-if="cpp" style="display:none">Regiongrowing</span><span data-if="com" style="display:none">Regiongrowing</span><span data-if="dotnet" style="display:none">Regiongrowing</span><span data-if="python" style="display:none">regiongrowing</span></a></code>
</p>
<h2 id="sec_alternatives">可替代算子</h2>
<p>
<code><a href="dilation1.html"><span data-if="hdevelop" style="display:inline">dilation1</span><span data-if="c" style="display:none">dilation1</span><span data-if="cpp" style="display:none">Dilation1</span><span data-if="com" style="display:none">Dilation1</span><span data-if="dotnet" style="display:none">Dilation1</span><span data-if="python" style="display:none">dilation1</span></a></code>
</p>
<h2 id="sec_see">参考其它</h2>
<p>
<code><a href="expand_gray.html"><span data-if="hdevelop" style="display:inline">expand_gray</span><span data-if="c" style="display:none">expand_gray</span><span data-if="cpp" style="display:none">ExpandGray</span><span data-if="com" style="display:none">ExpandGray</span><span data-if="dotnet" style="display:none">ExpandGray</span><span data-if="python" style="display:none">expand_gray</span></a></code>, 
<code><a href="interjacent.html"><span data-if="hdevelop" style="display:inline">interjacent</span><span data-if="c" style="display:none">interjacent</span><span data-if="cpp" style="display:none">Interjacent</span><span data-if="com" style="display:none">Interjacent</span><span data-if="dotnet" style="display:none">Interjacent</span><span data-if="python" style="display:none">interjacent</span></a></code>, 
<code><a href="skeleton.html"><span data-if="hdevelop" style="display:inline">skeleton</span><span data-if="c" style="display:none">skeleton</span><span data-if="cpp" style="display:none">Skeleton</span><span data-if="com" style="display:none">Skeleton</span><span data-if="dotnet" style="display:none">Skeleton</span><span data-if="python" style="display:none">skeleton</span></a></code>
</p>
<h2 id="sec_module">模块</h2>
<p>
Foundation</p>
<!--OP_REF_FOOTER_START-->
<hr>
<div class="indexlink">
<a href="index_classes.html"><span data-if="dotnet" style="display:none;">类别</span><span data-if="cpp" style="display:none;">类别</span></a><span data-if="dotnet" style="display:none;"> | </span><span data-if="cpp" style="display:none;"> | </span><a href="index_by_name.html">算子列表</a>
</div>
<div class="footer">
<div class="copyright">HALCON算子参考手册 Copyright © 2015-2023 51Halcon</div>
</div>
</div>
</body>
</html>
